Getting Started
Applying for API Access
Applying for access to the New Zealand Post Shipping APIs is a simple three step process.
Step 1. Register for a https://www.nzpost.co.nz account
You can do this by navigating here.
Step 2. Complete the commercial access form
This form provides us with the required billing information which is attached to your API key. This form only needs to be filled out once for your organization and must be completed in order for us to approve your application. You can access the form here.
Step 3. Request API access for an application
(Please note that you will need to repeat this step for each API you're wanting access to)
Navigate to the technical documentation for the API you're wanting to access. You can find links to our technical documentation on this page (simply click on the name of the API you're after).
At the top of the technical documentation page, click the "Request API access" button:
Either:
Select one of your existing applications (if you have already requested access for other APIs) or
Add a “new application”.
When registering a new application, include OAuth 2.0 grant type "Client Credentials Grant".
Select the SLA tier you would like to use.
Read the Terms & Conditions and check the box to accept these.
Hit request access.
Your access request will be assessed and approved within 2-3 working days. You will receive an e-mail upon approval.
If you require access to our UAT environment, please get in touch with our support team at api@nzpost.co.nz. Make sure you provide us with the name of your application.
Retrieving your client_id/client_secret
You can retrieve your client_id/client_secret by navigating to the following page, these keys are used for accessing our APIs:
https://anypoint.mulesoft.com/exchange/portals/nz-post-group/applications/
From here, simply click on the name of your application:
